home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / PROGEDIT / 0344.ZIP / EDWIN.DOC < prev    next >
Text File  |  1986-05-09  |  11KB  |  233 lines

  1. EDWIN is a programmer's editor based on the Borland Editor
  2. Toolbox. It offers multiple editing windows, block moves between
  3. windows, undeletion, pop-up help, Pascal structure editing,
  4. macro record and playback, DOS invocation from the editor, and
  5. file size limited only by available RAM.
  6.  
  7. For IBM PC and true compatibles. Keystrokes are WordStar
  8. compatible by default, but are fully configurable. Works with
  9. monochrome or color cards. Requires 256K.
  10.  
  11. When you first start the editor, the files EDWIN.ERR, EDWIN.KEY
  12. and EDWIN.HLP should be in the current drive and directory.
  13. Running the EDWINST program allows you to specify another
  14. pathname for each file.
  15.  
  16. EDWINST will let you customize the screen colors, screen speed,
  17. default toggles, the full keyboard, and several other defaults.
  18. Run it while EDWIN.COM is in the default directory and it will
  19. prompt you through.
  20.  
  21. All editor commands are summarized in the file EDWIN.HLP, which
  22. can be typed as a text file, and also used within the editor via
  23. the ^JH or ^OH help commands.
  24.  
  25. ****************************************************************
  26.  
  27. Written by Kim Kokkonen, TurboPower Software.
  28. Based on the Borland International Editor Toolbox.
  29.  
  30. Version 1.3 - 5/86
  31. Telephone: 408-378-3672  (9AM-5PM M-F Pacific Time)
  32. Compuserve: 72457,2131
  33. Address: TurboPower Software
  34.          478 W. Hamilton Ave. #196
  35.          Campbell, CA 95008
  36.  
  37. This program has been released to the public domain for personal,
  38. non-commercial use only. You may use it yourself, give it to your
  39. friends or co-workers, or distribute it for a cost-based fee as
  40. part of a user's group or bulletin board service. If you wish to
  41. distribute this program as part of a commercial package, please
  42. contact us for a license agreement.
  43.  
  44. If you ask for support or updates of this program, please expect
  45. to make a donation. We will ask $10 to send you the latest
  46. version of the program.
  47.  
  48. *****************************************************************
  49.  
  50. Version 1.3 offers the following improvements:
  51.  
  52.   -The installation options have been upgraded. The installation
  53.   program is now separate from the editor itself, contained in a
  54.   program called EDWINST.COM. We think this is the installation
  55.   program that Borland should use with their products.
  56.   Keystrokes for all commands can be customized in a full screen
  57.   editing environment. Colors and screen speed can be chosen.
  58.   Default toggles and pathnames for the EDWIN configuration
  59.   files can be set. The operation of EDWINST should be self-
  60.   explanatory. Just be sure that the files EDWIN.COM, EDWIN.KEY,
  61.   EDWIN.ERR, and EDWIN.HLP are all in the default drive and
  62.   directory when you run EDWINST. If you change the key
  63.   configuration to emulate a popular editor, we would like to
  64.   get a copy of your KEY file to help others out. Unfortunately,
  65.   the help file is not automatically updated when the keyboard
  66.   configuration is changed. You can manually update it after you
  67.   reconfigure the keyboard. If you do so, we would like to get a
  68.   copy of that too.
  69.  
  70.   -A third text window has been enabled. Add a text window at
  71.   any time with the ^OA command. Switch windows with the ^OO
  72.   command. Shrink the current window via ^OS, and grow it with
  73.   ^OG. Multiple windows can have the same or differing files.
  74.  
  75.   -Up to three files may be read in based on command line
  76.   parameters. Call the program as EDWIN File1 File2 File3.
  77.  
  78.   -Memory management has been improved. Minimum memory usage per
  79.   line is now 24 bytes instead of 48. Text line buffers are
  80.   incremented in steps of 8 bytes rather than 16. Behavior when
  81.   the editor runs out of memory is more graceful! Line length is
  82.   limited to 1024 characters. Longer lines will be split up when
  83.   the file is read. The end of line terminator is <CR><LF>.
  84.  
  85.   -Macro support has been improved. Macros are created via the
  86.   ^JT command. The first ^JT turns macro recording on. All of
  87.   your keystrokes will be recorded until you type ^JT again. You
  88.   will be prompted for the macro number you want to store.
  89.   Respond with <Enter> or a number from 1 through 9. <Enter>
  90.   stores the "scrap" macro. This macro will be available until
  91.   the next time you start recording. The scrap macro can be used
  92.   in several ways, as described below. The 9 numbered macros can
  93.   be invoked via alt-1 (top row 1) through alt-9. The "scrap"
  94.   macro can be inserted from 1 to 9 times directly via the ^Jn
  95.   (^J1 through ^J9) commands or for a larger (prompted) number
  96.   of times via the ^JI command. All macros can be saved and
  97.   loaded from files via the ^JW and ^JR options, respectively.
  98.  
  99.   -Text markers are now visible. Visibility can be toggled via
  100.   the ^KM option. Text markers are set via the commands ^K0
  101.   through ^K9. You can move to the associated marker with ^Q0
  102.   through ^Q9.
  103.  
  104.   -All block operations have been sped up and cleaned up. The
  105.   mark word (^KT) operation has been implemented.
  106.  
  107.   -Change case options (^OT,^OU,^OL) affect case of entire
  108.   marked block, or of a single character if no block is marked.
  109.   ^OT toggles case, ^OU uppercases, and ^OL lowercases. The
  110.   cursor must be WITHIN the marked block for change case to work
  111.   within the entire block.
  112.  
  113.   -Find (^QF) and replace (^QA) now support options for case-
  114.   sensitive searching, whole words only, and backwards searches.
  115.   Search speed has been improved by about an order of magnitude.
  116.   Thanks to Randy Forgaard for the speedy INLINE search code.
  117.  
  118.   -Search and replace add a new feature. They can be confined to
  119.   operate within just a marked block. The block must be visible
  120.   for this to work, and you must choose the M option from the
  121.   search or replace menu to activate it. We believe that the
  122.   block search/replace option is more useful than the
  123.   search/replace for "n" times option, which is not implemented
  124.   here.
  125.  
  126.   -There is another search related feature which is new and
  127.   quite powerful. It is called "search and apply macro" (^QM).
  128.   It is like search and replace except that any macro can
  129.   applied at the location of the match rather than just
  130.   substituting a string there. You use it just like ^QA except
  131.   that you specify a previously stored macro number (1..9 or
  132.   <Enter> for the current scrap macro) instead of a replace
  133.   string. You'll need to be careful with this one. Applying a
  134.   macro which itself does a find or replace will lead to
  135.   disaster. Use it carefully until you understand what it can do.
  136.  
  137.   -If you do a global (G) or marked (M) replace, each preview
  138.   will produce a prompt with the options Y/N/A/Q. Y means change
  139.   this instance and search again, N means don't change this one
  140.   but continue searching, A means change this one and all others
  141.   thereafter without prompting, and Q means quit right now.
  142.  
  143.   -Built-in help (^OH or ^JH) now scrolls with the keypad, and
  144.   scrolls page by page rather than line by line.
  145.  
  146.   -"Snow control" is fixed, unfortunately at the expense of
  147.   screen speed on IBM color graphics adapters. Try the EDWINST
  148.   program to determine if your color display card can run faster
  149.   without snow.
  150.  
  151.   -"Smart tabs" a la the Turbo Pascal editor have been
  152.   implemented. All but some of the more quirky behavior of Turbo
  153.   is implemented here.
  154.  
  155.   -By default, tab characters are expanded to spaces during
  156.   read-in of any file. These expansions occur on standard 8
  157.   column boundaries. WARNING: the tabs are lost if you write the
  158.   file out again. EDWIN does not reconvert them to tabs. An
  159.   installation option allows you to leave tabs unchanged during
  160.   read-in.
  161.  
  162.   -Move to previous cursor position (^QP) has been implemented.
  163.  
  164.   -Restore current line (^QL) has been implemented.
  165.  
  166.   -All of the command prompts for strings (like filenames,
  167.   search and replace strings, directories) are now supported by
  168.   a command line editor with the same functionality as that in
  169.   the Turbo Pascal editor. ^R restores the previous value, ^D
  170.   brings it back a character at a time, ^S/^H delete it, ^V
  171.   toggles insert mode, etc. The IBM keypad is also functional
  172.   here. Thanks to Bela Lubkin for this code (and also for his
  173.   EXEC function).
  174.  
  175.   -Read and write block commands leave the block markers
  176.   properly set.
  177.  
  178.   -The end of file marker written to the end of EDWIN files is
  179.   selectable as an installation option. By default, a ^Z
  180.   character is written to the end of all files. This can be
  181.   changed to no terminator (useful with DOS append commands) or
  182.   to a <CR><LF>^Z terminator.
  183.  
  184.   -A command to append block to file has been added. ^KA writes
  185.   the marked block to the end of the named file, using a
  186.   technique to avoid embedded ^Z (end of file) marks in the
  187.   result. It protects against the standard WordStar files which
  188.   are padded to 128 byte boundaries with ^Z's.
  189.  
  190.   -All write operations are now buffered (through a 4K buffer)
  191.   for a 2-3x speed improvement.
  192.  
  193.   -The DOS shell now gives all available memory to the command
  194.   processor. Actual amount will vary from about 20K minimum up
  195.   to about 400K free. Since the technique uses only non-
  196.   fragmented heap space as part of the DOS free space, it is
  197.   possible that a fragmented heap will cause very little memory
  198.   to be available to DOS in spite of the fact that the ^OM EDWIN
  199.   command reports lots of free memory. The only way to get
  200.   around this is to save all opened files and quit to the main
  201.   menu via the ^KD command.
  202.  
  203.   -A DOS critical error handler is installed within the program.
  204.   This keeps drive or printer errors from crashing EDWIN with
  205.   Abort, Retry, Ignore messages. Thanks (again) to Bela Lubkin
  206.   for this code.
  207.  
  208.   -Primitive text processing commands have been added. ^OR sets
  209.   the right margin. ^OW toggles word wrap mode on and off. ^B
  210.   reformats a "paragraph" to fill within the right margin. A
  211.   paragraph is any sequence of text lines terminated with a
  212.   blank line. Word wrap mode must be active for ^B to perform
  213.   filling. ^B operation is affected by whether Autoindent mode
  214.   is active. If Autoindent is on, each line of a reformatted
  215.   paragraph will be indented the same as the line on which
  216.   reformatting started. If Autoindent is off, the first line of
  217.   a paragraph may be indented while succeeding lines will be
  218.   flush left in column 1. Automatic word wrap (a new line
  219.   inserted whenever you type beyond the current margin) is also
  220.   supported by this version whenever word wrap is active.
  221.  
  222.   -A full complement of "jump to" commands is available. You can
  223.   jump to a specific line number with the ^ON command, to a
  224.   specific column number with the ^OC command, and to a specific
  225.   window with the ^OQ command. Windows are numbered starting
  226.   from 1 for the top window on the screen. In addition, any of
  227.   the "jump to" commands can be used in a relative sense. If you
  228.   respond to the prompt for a line number with, e.g., +10, the
  229.   jump will be made to 10 lines below the current one.
  230.   Similarly, -20 would jump 20 lines toward the beginning of the
  231.   file. These relative jumps may be useful in designing macros
  232.   for the editor.
  233.